<?php

/*
	[Discuz!] (C)2001-2007 Comsenz Inc.
	This is NOT a freeware, use is subject to license terms

	$Id: db_mysql.class.php 13278 2008-04-03 09:39:07Z cnteacher $
*/
///////////////////////////////////////////////////////////
//分析者：SamPeng
//分析时间：2008-10-4
//分析文件名：install/index.php
///////////////////////////////////////////////////////////

//和所有被引用的文件一样。通过判断IN_DISCUZ是否为真而是否继续。
if(!defined('IN_DISCUZ')) {
	exit('Access Denied');
}
//创建一个类。
class dbstuff {
	//一些常量的的设定
	var $version = '';
	var $querynum = 0;
	var $link;
	//定义链接方法
	function connect($dbhost, $dbuser, $dbpw, $dbname = '', $pconnect = 0, $halt = TRUE, $dbcharset2 = '') {
	//在方法定义传递参数时候就设置的pconnect=0.这个参数用来判断是否是个持续链接。
	//$func变量用来存储，判断$pconnect是否为空，如果是，则存储php到mysql的链接（非持续性）的方法名。反之，则存储php到mysql的持续链接的方法名。
		$func = empty($pconnect) ? 'mysql_connect' : 'mysql_pconnect';
		//建立一个链接给类的属性link之中。并且在建立链接的时候就设定编码方式是如何的。
		if(!$this->link = @$func($dbhost, $dbuser, $dbpw, 1)) {
			$halt && $this->halt('Can not connect to MySQL server');
		} else {
			if($this->version() > '4.1') {
				global $charset, $dbcharset;
				$dbcharset = $dbcharset2 ? $dbcharset2 : $dbcharset;
				$dbcharset = !$dbcharset && in_array(strtolower($charset), array('gbk', 'big5', 'utf-8')) ? str_replace('-', '', $charset) : $dbcharset;
				$serverset = $dbcharset ? 'character_set_connection='.$dbcharset.', character_set_results='.$dbcharset.', character_set_client=binary' : '';
				$serverset .= $this->version() > '5.0.1' ? ((empty($serverset) ? '' : ',').'sql_mode=\'\'') : '';
				$serverset && mysql_query("SET $serverset", $this->link);
			}
			$dbname && @mysql_select_db($dbname, $this->link);
		}

	}
	//定义一个选择数据库的方法
	function select_db($dbname) {
		return mysql_select_db($dbname, $this->link);
	}
	//定义一个数据库执行后的返回方法
	function fetch_array($query, $result_type = MYSQL_ASSOC) {
		return mysql_fetch_array($query, $result_type);
	}
	//定义一个方法，方法中返回fetch_array方法执行后的返回值
	function fetch_first($sql) {
		return $this->fetch_array($this->query($sql));
	}
	//定义一个方法，方法中返回result方法执行后的返回值
	function result_first($sql) {
		return $this->result($this->query($sql), 0);
	}
	//定义一个方法。方法中执行对数据库的操作。
	function query($sql, $type = '') {
		//定义全局变量
		global $debug, $discuz_starttime, $sqldebug, $sqlspenttimes;
		//判断并且引入debug文件。
		if(defined('SYS_DEBUG') && SYS_DEBUG) {
			@include_once DISCUZ_ROOT.'./include/debug.func.php';
			sqldebug();
		}
		//数据库操作。。不明具体的判断。
		$func = $type == 'UNBUFFERED' && @function_exists('mysql_unbuffered_query') ?
			'mysql_unbuffered_query' : 'mysql_query';
		if(!($query = $func($sql, $this->link))) {
			if(in_array($this->errno(), array(2006, 2013)) && substr($type, 0, 5) != 'RETRY') {
				$this->close();
				require DISCUZ_ROOT.'./config.inc.php';
				$this->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset);
				$this->query($sql, 'RETRY'.$type);
			} elseif($type != 'SILENT' && substr($type, 5) != 'SILENT') {
				$this->halt('MySQL Query Error', $sql);
			}
		}

		$this->querynum++;
		return $query;
	}
	//mysql_affected_rows -- 取得前一次 MySQL 操作所影响的记录行数
	function affected_rows() {
		return mysql_affected_rows($this->link);
	}
	//数据库的文本错误提示
	function error() {
		return (($this->link) ? mysql_error($this->link) : mysql_error());
	}
	//mysql_errno --  返回上一个 MySQL 操作中的错误信息的数字编码 
	function errno() {
		return intval(($this->link) ? mysql_errno($this->link) : mysql_errno());
	}
	//返回数据库操作结果
	function result($query, $row = 0) {
		$query = @mysql_result($query, $row);
		return $query;
	}
	//返回数据库查询等操作的数目
	function num_rows($query) {
		$query = mysql_num_rows($query);
		return $query;
	}
	//mysql_num_fields-取得结果集中字段的数目
	function num_fields($query) {
		return mysql_num_fields($query);
	}
	//释放结果内存
	function free_result($query) {
		return mysql_free_result($query);
	}
	//mysql_insert_id --  取得上一步 INSERT 操作产生的 ID
	function insert_id() {
		return ($id = mysql_insert_id($this->link)) >= 0 ? $id : $this->result($this->query("SELECT last_insert_id()"), 0);
	}
	//以数组的形式返回查询结果
	function fetch_row($query) {
		$query = mysql_fetch_row($query);
		return $query;
	}
	//mysql_fetch_field --  从结果集中取得列信息并作为对象返回 
	function fetch_fields($query) {
		return mysql_fetch_field($query);
	}
	//获取版本信息，mysql_get_server_info()返回mysql服务器信息
	function version() {
		if(empty($this->version)) {
			$this->version = mysql_get_server_info($this->link);
		}
		return $this->version;
	}
	//关闭链接
	function close() {
		return mysql_close($this->link);
	}
	//错误提示
	function halt($message = '', $sql = '') {
		define('CACHE_FORBIDDEN', TRUE);
		require_once DISCUZ_ROOT.'./include/db_mysql_error.inc.php';
	}
}

?>